home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / STUTTGART / UTIL / PRINTER / DUALPRINT / _files / _DualPrint / _Help next >
Text File  |  1990-09-26  |  6KB  |  158 lines
  1.  !Help for DualPrint Version 1.28
  2.  ----------------------------------
  3.  
  4. Files included in this package :-
  5.  
  6. !Run
  7. !RunImage
  8. !Sprites
  9. !Help
  10. DualComs
  11. Templates
  12.  
  13.  Purpose
  14. ---------
  15.  
  16. DualPrint facilitates the printing of 2 column BASIC listings.
  17.  
  18. 10 *****                 10 *****  30 ***
  19. 20 ****                  20 ****   40 **
  20. 30 ***    > DualPrint >            50 *
  21. 40 **
  22. 50 *
  23.  
  24.  Usage
  25. -------
  26.  
  27. Use *SPOOL or BEEBUG's "B_to_T" to generate a text file listing of the BASIC
  28. program you want displayed, then drag the file onto the DualPrint icon. Menu
  29. on the icon permits you to change the print pitch so that long lines are
  30. less likely to be split up. The selection is recorded by the tick to the
  31. left of the item. If your printer is not listed, manually configure it to
  32. the desired print pitch, then use the Any printer option to tell DualPrint
  33. the number of characters on each line. To abort printing press <ESCAPE>.
  34.  
  35.  Notes
  36. -------
  37.  
  38. Even when printing DualPrint is a multi-tasking application. Multiple
  39. installations of DualPrint are impossible. When a file is dragged onto the
  40. DualPrint icon it is copied onto the ram disc as "PrintFile". This file can
  41. itself be dragged onto DualPrint if you require a second copy. If the file
  42. is too large for the ram disc an error message will be issued giving the
  43. amount of memory to assign to the ram disc. Only DATA and TEXT files are
  44. received. Any files which contain less than 2 numbered lines are ignored. It
  45. is impossible to load up a second file whilst DualPrint is processing the
  46. first. Lines from the file will be displayed only if they are terminated by
  47. a character of ASCII value 13 or less and the first non-space character is a
  48. numeral. If P is the print width (10 - 255 characters) the layout of a line
  49. is as follows :-
  50.  
  51. {(P DIV 2 - 1) chars}"  "{(P DIV 2 - 1) chars}
  52.  
  53. A listing is split so that there is always a new line of BASIC heading the
  54. second column. Lines are sent to the printer once every null "Wimp_Poll"
  55. with *FX 3,10.
  56.  
  57.  DualComs 1.05
  58. ---------------
  59.  
  60. This module provides 2 *Commands used by DualPrint.
  61.  
  62. CheckEsc is the means by which DualPrint responds to the user pressing
  63. <ESCAPE>. If the command is prefixed by a 1 the keyboard event is enabled
  64. and an event handler installed; a 0 parameter removes the handler and
  65. releases the event. Attempts to install or remove the handler twice in
  66. succession will be ignored. After a CheckEsc command without a parameter the
  67. escape state will be passed in the user flag. If the user flag is set to 27
  68. the <ESCAPE> key has been pressed since the last check.
  69.  
  70. Syntax : *CheckEsc [<0 1>]
  71.  
  72. RamFS reserves an area of memory for the RAM Filing system. The size can be
  73. either bytes or Kilobytes, but the value will be rounded up to the nearest
  74. page boundary. If the ram disc is already larger than the new setting or if
  75. it contains files then it will not be altered.
  76.  
  77. Syntax : *RamFS <size>[K]
  78.  
  79.  Versions
  80. ----------
  81.  
  82. 1.00  Fully functional.
  83.  
  84. 1.10  Menu expanded to cope with any printer, but the user must initialise
  85.       the printer as required. Responds to !Help. Fix for an obscure bug.
  86.       Appended ">"  to listing. Traps Filing system or path 'RAM:' not
  87.       present error. Checks to see whether the printer is connected. When
  88.       printing is in progress, the printer options are shaded and pressing
  89.       <ESCAPE> halts the precedings.
  90.  
  91. 1.11  Major flaw in the print layout corrected.
  92.  
  93. 1.20  Listings enhanced by the identation of broken lines. Pause between
  94.       pages implemented. PrintFile window contains name, number of lines,
  95.       printer, print width, pause option, indent option and page length. The
  96.       printer characteristics can be changed whilst the window is on screen.
  97.       Polished the printer sensing. Debugged DualComs.
  98.  
  99. 1.21  Prevented the options icons from becoming out of sync with the setting
  100.       as a result of dragging. Improved the loading procedure. Definitive
  101.       DualComs. Fixed 2 bugs in the file analysis routine.
  102.  
  103. 1.22  Optimised the templates and made a few aesthetic changes to the
  104.       program.
  105.  
  106. 1.23  Increased the WimpSlot to 32K. Improved !Help and made a few pedantic
  107.       alterations. Final version of DualComs. If an application save is
  108.       unsuccessful, DualPrint now ignores it.
  109.  
  110. 1.24  New technique adopted for application saves. Removed a redundant error
  111.       message. Corrected the templates so that indent works again. Files
  112.       which are not control code terminated now have a carriage return (13)
  113.       appended. Increased the minimum Pause length to 3 lines.
  114.  
  115. 1.25  Adjust on the Pause arrows now has the reverse effect. Pause no longer
  116.       sends a form feed at the end of each page. Select on a printer chooses
  117.       the first print pitch on the submenu. Ultimate version of DualComs.
  118.  
  119. 1.26  Changing the print pitch with the PrintFile window open now gives the
  120.       correct results.
  121.  
  122. 1.27  The file is scanned a second time prior to printing to account for
  123.       print pitch and indent changes.
  124.  
  125. 1.28  The file is scanned again only if the indent or print width changes.
  126.  
  127.  Also by this author
  128. ---------------------
  129.  
  130. !FormSize  (1.02)  Calculate Template workspace.
  131.  
  132.  Conditions of Use
  133. -------------------
  134.  
  135. This application is supplied free for general use "as is", I cannot
  136. guarantee that it is free from bugs or give any warranty about its
  137. suitability for use. You have my permission to give this program to anyone
  138. you please via any medium, provided it is delivered with ALL original files.
  139. Please notify me immediately if you have any problems and I will see what
  140. can be done. I expressly forbid anybody to supply this program on a disc
  141. which is being charged for. If you bought this program contact me
  142. immediately. If you want to borrow some of my code for another shareware
  143. project then please remember to credit me! If you want to use my work for
  144. sale then my acceptance must be sought in writing. I maintain copyright on
  145. all the material supplied and reserve the right to amend these conditions
  146. in cases where I deem misuse.
  147.  
  148.  Contacts
  149. ----------
  150.  
  151. 63 Cromwell Rd
  152. Canterbury
  153. KENT
  154. CT1 3LE
  155.  
  156. © Mark.J.Collier 1990
  157.  
  158.